home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / archie / doc / archie.doc next >
Text File  |  1995-08-16  |  11KB  |  265 lines
  1.  
  2.  
  3.  
  4. ARCHIE(1)                 User Commands                 ARCHIE(1)
  5.  
  6.  
  7.  
  8. N_N_N_NA_A_A_AM_M_M_ME_E_E_E
  9.      archie - query the  Archie  anonymous  FTP  databases  using
  10.      Prospero
  11.  
  12. S_S_S_SY_Y_Y_YN_N_N_NO_O_O_OP_P_P_PS_S_S_SI_I_I_IS_S_S_S
  13.      a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e [_[_[_[ -_-_-_-c_c_c_ce_e_e_er_r_r_rs_s_s_s ] [ -_-_-_-a_a_a_a ] [ -_-_-_-l_l_l_l ] [ -_-_-_-t_t_t_t ] [ -_-_-_-m_m_m_m hits ]
  14.             [ -_-_-_-N_N_N_N [_[_[_[ level ] ] [ -_-_-_-h_h_h_h hostname ] [ -_-_-_-o_o_o_o filename ]
  15.             [ -_-_-_-L_L_L_L ] [ -_-_-_-V_V_V_V ] [ -_-_-_-v_v_v_v ] string
  16.  
  17. D_D_D_DE_E_E_ES_S_S_SC_C_C_CR_R_R_RI_I_I_IP_P_P_PT_T_T_TI_I_I_IO_O_O_ON_N_N_N
  18.      a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e queries an archie anonymous FTP database looking  for
  19.      the  specified  string  using  the  P_P_P_Pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o protocol.  This
  20.      client is based on P_P_P_Pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o version Beta.4.2 and is provided
  21.      to  encourage non-interactive use of the Archie servers (and
  22.      subsequently better performance on both  sides).   This  man
  23.      page describes version 1.3 of the client.
  24.  
  25.      The general method of use is of the form
  26.  
  27.           % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e s_s_s_st_t_t_tr_r_r_ri_i_i_in_n_n_ng_g_g_g
  28.  
  29.      This will go to the archie server and ask it to look for all
  30.      known  systems  that have a file named `string' in their FTP
  31.      area.  a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e will wait, and print out any matches.
  32.  
  33.      For example,
  34.  
  35.           % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s
  36.  
  37.      will find all anonymous FTP sites  in  the  archie  database
  38.      that  have  files  named  e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s somewhere in their FTP area.
  39.      (This particular query would probably return a lot of direc-
  40.      tories.)  If you want a list of every filename that contains
  41.      e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s anywhere in it, you'd use
  42.  
  43.           % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e -_-_-_-c_c_c_c e_e_e_em_m_m_ma_a_a_ac_c_c_cs_s_s_s
  44.  
  45.      Regular expressions, such as
  46.  
  47.           % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e -_-_-_-r_r_r_r '_'_'_'[_[_[_[x_x_x_xX_X_X_X]_]_]_][_[_[_[l_l_l_lL_L_L_L]_]_]_]i_i_i_is_s_s_sp_p_p_p'_'_'_'
  48.  
  49.      may also be used for searches.  (See the manual of a reason-
  50.      ably good editor, like GNU Emacs or vi, for more information
  51.      on using regular expressions.)
  52.  
  53.  
  54. O_O_O_OP_P_P_PT_T_T_TI_I_I_IO_O_O_ON_N_N_NS_S_S_S
  55.      The options currently available to this a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e client are:
  56.  
  57.      -_-_-_-c_c_c_c          Search substrings paying attention  to  upper  &
  58.                  lower case.
  59.      -_-_-_-e_e_e_e          Exact string match.  (This is the default.)
  60.  
  61.  
  62.  
  63. Archie (Prospero) Last change: 26 October 1992                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ARCHIE(1)                 User Commands                 ARCHIE(1)
  71.  
  72.  
  73.  
  74.      -_-_-_-r_r_r_r          Search using a regular expression.
  75.      -_-_-_-s_s_s_s          Search  substrings  ignoring  the  case  of  the
  76.                  letters.
  77.      -_-_-_-o_o_o_ofilename  If specified, place the results of the search in
  78.                  filename.
  79.      -_-_-_-a_a_a_a          Output results as Alex filenames.
  80.      -_-_-_-l_l_l_l          Output results in a form suitable for parsing by
  81.                  programs.
  82.      -_-_-_-t_t_t_t          Sort the results inverted by date.
  83.      -_-_-_-m_m_m_mhits      Specifies the maximum number of  hits  (matches)
  84.                  to return (default of 9_9_9_95_5_5_5).
  85.      -_-_-_-N_N_N_Nlevel     Sets the niceness of a query; by  default,  it's
  86.                  set  to 0.  Without an argument, ``-N'' defaults
  87.                  to 3_3_3_35_5_5_57_7_7_76_6_6_65_5_5_5.   If  you  use  -_-_-_-N_N_N_N  with  an  argument
  88.                  between 0 and 35765, it'll adjust itself accord-
  89.                  ingly.  (N_N_N_No_o_o_ot_t_t_te_e_e_e: VMS users will have to put quotes
  90.                  around  this  argument, and -_-_-_-L_L_L_L, like "-_-_-_-N_N_N_N4_4_4_45_5_5_5"; VMS
  91.                  will otherwise convert it to lowercase.)
  92.      -_-_-_-h_h_h_h hostname Tells the client  to  query  the  Archie  server
  93.                  hostname.
  94.      -_-_-_-L_L_L_L          Lists the Archie servers known  to  the  program
  95.                  when it was compiled, as well as the name of the
  96.                  default Archie server.  For an up-to-date  list,
  97.                  write  to  ``archie@archie.mcgill.ca''  (or  any
  98.                  Archie  server)  with  the  single  command   of
  99.                  servers.
  100.      -_-_-_-V_V_V_V          With the verbose option, a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e will  make  some
  101.                  comments  along  the way if a search is going to
  102.                  take some time, to pacify the user.
  103.  
  104.      The three search-modifying arguments  (``-c'',  ``-r'',  and
  105.      ``-s'')  are  all  mutually  exclusive;  only  the  last one
  106.      counts.  If you specify -_-_-_-e_e_e_e with any of  ``-c'',  ``-r'',  or
  107.      ``-s'', the server will first check for an exact match, then
  108.      fall back to the case-sensitive, case-insensitive, or  regu-
  109.      lar expression search.  This is so if there are matches that
  110.      are particularly obvious, it will take a minimal  amount  of
  111.      time to satisfy your request.
  112.  
  113.      If you list a single `-' by itself,  any  further  arguments
  114.      will  be  taken  as  part  of  the  search  string.  This is
  115.      intended to enable searching for strings that begin  with  a
  116.      `-'; for example:
  117.  
  118.           % a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e -_-_-_-s_s_s_s -_-_-_- -_-_-_-o_o_o_ol_l_l_ld_d_d_d
  119.  
  120.      will search for all filenames that contain the string `-old'
  121.      in them.
  122.  
  123. R_R_R_RE_E_E_ES_S_S_SP_P_P_PO_O_O_ON_N_N_NS_S_S_SE_E_E_E
  124.      Archie servers are set up to respond to a number of requests
  125.      in  a  queued fashion.  That is, smaller requests get served
  126.  
  127.  
  128.  
  129. Archie (Prospero) Last change: 26 October 1992                  2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ARCHIE(1)                 User Commands                 ARCHIE(1)
  137.  
  138.  
  139.  
  140.      much more quickly than do large requests.  As a result,  the
  141.      more  often  you query the Archie server, or the larger your
  142.      requests, the longer the queue will become, resulting  in  a
  143.      longer  waiting  period  for everyone's requests.  Please be
  144.      frugal when possible, for your benefit as well  as  for  the
  145.      other users.
  146.  
  147. Q_Q_Q_QU_U_U_UE_E_E_ER_R_R_RY_Y_Y_Y P_P_P_PR_R_R_RI_I_I_IO_O_O_OR_R_R_RI_I_I_IT_T_T_TY_Y_Y_Y
  148.      Please use the  ``-N''  option  whenever  you  don't  demand
  149.      immediacy,  or when you're requesting things that could gen-
  150.      erate large responses.  Even when using the nice option, you
  151.      should  still  try  to  avoid  big jobs during busy periods.
  152.      Here is a list of what we consider to be  nice  values  that
  153.      accurately reflect the priority of a job to the server.
  154.  
  155.           N_N_N_No_o_o_or_r_r_rm_m_m_ma_a_a_al_l_l_l              0
  156.           N_N_N_Ni_i_i_ic_c_c_ce_e_e_e                500
  157.           N_N_N_Ni_i_i_ic_c_c_ce_e_e_er_r_r_r               1000
  158.           V_V_V_Ve_e_e_er_r_r_ry_y_y_y N_N_N_Ni_i_i_ic_c_c_ce_e_e_e           5000
  159.           E_E_E_Ex_x_x_xt_t_t_tr_r_r_re_e_e_em_m_m_me_e_e_el_l_l_ly_y_y_y N_N_N_Ni_i_i_ic_c_c_ce_e_e_e      10000
  160.           N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t              32765
  161.  
  162.      The last priority, N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t, would be used when a  job  should
  163.      wait  until  the  queue is essentially empty before running.
  164.      You should pick one of these values to use, possibly modify-
  165.      ing  it  slightly depending on where you think your priority
  166.      should land.  For example, 32760 would mean wait  until  the
  167.      queue  is  empty,  but  jump  ahead  of other jobs that have
  168.      selected N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t.
  169.  
  170.      There are certain types of  things  that  we  suggest  using
  171.      N_N_N_Ni_i_i_ic_c_c_ce_e_e_es_s_s_st_t_t_t  for,  irregardless.  In particular, any searches for
  172.      which you would have a hard time justifying the use of  any-
  173.      thing but extra resources.  (We all know what those searches
  174.      would be for.)
  175.  
  176. E_E_E_EN_N_N_NV_V_V_VI_I_I_IR_R_R_RO_O_O_ON_N_N_NM_M_M_ME_E_E_EN_N_N_NT_T_T_T
  177.      ARCHIE_HOST
  178.              This will change the host archie will  consult  when
  179.              making  queries.   (The default value is what's been
  180.              compiled in.)  The ``-h'' option will override this.
  181.              If  you're  running  VMS,  create  a  symbol  called
  182.              ARCHIE_HOST.
  183.  
  184. S_S_S_SE_E_E_EE_E_E_E A_A_A_AL_L_L_LS_S_S_SO_O_O_O
  185.      For more information on regular expressions, see the  manual
  186.      pages on:
  187.  
  188.      r_r_r_re_e_e_eg_g_g_ge_e_e_ex_x_x_x(3),_,_,_, e_e_e_ed_d_d_d(1)
  189.  
  190.      Also   read    the    file    a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e/_/_/_/d_d_d_do_o_o_oc_c_c_c/_/_/_/w_w_w_wh_h_h_ha_a_a_at_t_t_ti_i_i_is_s_s_s._._._.a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e    on
  191.      a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a for a detailed paper on Archie as a whole.
  192.  
  193.  
  194.  
  195. Archie (Prospero) Last change: 26 October 1992                  3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ARCHIE(1)                 User Commands                 ARCHIE(1)
  203.  
  204.  
  205.  
  206.      Read the file README.ALEX distributed with this  client  for
  207.      more information on what Alex is and how you can take advan-
  208.      tage of it.
  209. A_A_A_AU_U_U_UT_T_T_TH_H_H_HO_O_O_OR_R_R_RS_S_S_S
  210.      The a_a_a_ar_r_r_rc_c_c_ch_h_h_hi_i_i_ie_e_e_e service was conceived  and  implemented  by  Alan
  211.      Emtage       (b_b_b_ba_a_a_aj_j_j_ja_a_a_an_n_n_n@_@_@_@c_c_c_cs_s_s_s._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a),       Peter       Deutsch
  212.      (p_p_p_pe_e_e_et_t_t_te_e_e_er_r_r_rd_d_d_d@_@_@_@c_c_c_cs_s_s_s._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a),        and        Bill         Heelan
  213.      (w_w_w_wh_h_h_he_e_e_ee_e_e_el_l_l_la_a_a_an_n_n_n@_@_@_@c_c_c_cs_s_s_s._._._.m_m_m_mc_c_c_cg_g_g_gi_i_i_il_l_l_ll_l_l_l._._._.c_c_c_ca_a_a_a).   The  entire  Internet  is in their
  214.      debt.
  215.  
  216.      The  P_P_P_Pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o  system  was  created   by   Clifford   Neuman
  217.      (b_b_b_bc_c_c_cn_n_n_n@_@_@_@i_i_i_is_s_s_si_i_i_i._._._.e_e_e_ed_d_d_du_u_u_u);   write  to  i_i_i_in_n_n_nf_f_f_fo_o_o_o-_-_-_-p_p_p_pr_r_r_ro_o_o_os_s_s_sp_p_p_pe_e_e_er_r_r_ro_o_o_o@_@_@_@i_i_i_is_s_s_si_i_i_i._._._.e_e_e_ed_d_d_du_u_u_u  for  more
  218.      information on the protocol and its use.
  219.  
  220.      This stripped client  was  put  together  by  Brendan  Kehoe
  221.      (b_b_b_br_r_r_re_e_e_en_n_n_nd_d_d_da_a_a_an_n_n_n@_@_@_@c_c_c_cy_y_y_yg_g_g_gn_n_n_nu_u_u_us_s_s_s._._._.c_c_c_co_o_o_om_m_m_m),  with modifications by Clifford Neuman
  222.      and George Ferguson (f_f_f_fe_e_e_er_r_r_rg_g_g_gu_u_u_us_s_s_so_o_o_on_n_n_n@_@_@_@c_c_c_cs_s_s_s._._._.r_r_r_ro_o_o_oc_c_c_ch_h_h_he_e_e_es_s_s_st_t_t_te_e_e_er_r_r_r._._._.e_e_e_ed_d_d_du_u_u_u).
  223.  
  224. B_B_B_BU_U_U_UG_G_G_GS_S_S_S
  225.      There are none; only a few unexpected features.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Archie (Prospero) Last change: 26 October 1992                  4
  262.  
  263.  
  264.  
  265.